home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / wish.1 < prev    next >
Text File  |  1995-07-25  |  8KB  |  198 lines
  1.  
  2.  
  3.  
  4.      wwwwiiiisssshhhh((((1111))))                     TTTTkkkk ((((3333....3333))))                      wwwwiiiisssshhhh((((1111))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           wish - Simple windowing shell
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           wwwwiiiisssshhhh ?_o_p_t_i_o_n_s? ?_a_r_g _a_r_g ...?
  15.  
  16.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  17.           ----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y
  18.                          Display (and  screen)  on  which  to  display
  19.                          window.
  20.  
  21.           ----ffffiiiilllleeee _f_i_l_e_N_a_m_e Read  commands  from  _f_i_l_e_N_a_m_e  rather   than
  22.                          standard input.  The last element in _f_i_l_e_N_a_m_e
  23.                          will be used as the title for the application
  24.                          and name of its interpreter for sssseeeennnndddd commands
  25.                          (unless overridden by the ----nnnnaaaammmmeeee option).
  26.  
  27.           ----ggggeeeeoooommmmeeeettttrrrryyyy _g_e_o_m_e_t_r_y
  28.                          Initial geometry to use for window.
  29.  
  30.           ----nnnnaaaammmmeeee _n_a_m_e     Use _n_a_m_e as the title to be displayed in  the
  31.                          window,  and  as  the name of the interpreter
  32.                          for sssseeeennnndddd commands.
  33.  
  34.           ----ssssyyyynnnncccc          Execute all X server commands  synchronously,
  35.                          so  that  errors  are  reported  immediately.
  36.                          This will result in  much  slower  execution,
  37.                          but it is useful for debugging.
  38.  
  39.           ----hhhheeeellllpppp          Print a summary of the  command-line  options
  40.                          and exit.
  41.      _________________________________________________________________
  42.  
  43.  
  44.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  45.           WWWWiiiisssshhhh is a simple  program  consisting  of  the  Tcl  command
  46.           language,  the  Tk  toolkit,  and  a main program that reads
  47.           commands from standard input or from a file.  It  creates  a
  48.           main  window  and  then  processes Tcl commands.  If wwwwiiiisssshhhh is
  49.           invoked with  no  ----ffff  option  then  it  reads  Tcl  commands
  50.           interactively   from   standard  input.   It  will  continue
  51.           processing commands until all windows have been  deleted  or
  52.           until  end-of-file  is  reached on standard input.  If there  |
  53.           exists a file ....wwwwiiiisssshhhhrrrrcccc in the home  directory  of  the  user,  |
  54.           wwwwiiiisssshhhh  evaluates the file as a Tcl script just before reading  |
  55.           the first command from standard input.
  56.  
  57.           If the ----ffffiiiilllleeee option is provided to Tk, then wwwwiiiisssshhhh  reads  Tcl
  58.           commands  from  the  file  named in the ----ffffiiiilllleeee option.  These
  59.           commands  will  normally  create  an  interactive  interface
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      wwwwiiiisssshhhh((((1111))))                     TTTTkkkk ((((3333....3333))))                      wwwwiiiisssshhhh((((1111))))
  71.  
  72.  
  73.  
  74.           consisting  of  one  or  more  widgets.  When the end of the
  75.           command file is reached, wwwwiiiisssshhhh will continue to respond to  X
  76.           events  until  all  windows  have been deleted.  There is no  |
  77.           automatic evaluation of ....wwwwiiiisssshhhhrrrrcccc in this case, but the script  |
  78.           file can always ssssoooouuuurrrrcccceeee it if desired.
  79.  
  80.  
  81.      VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
  82.           WWWWiiiisssshhhh sets the following Tcl variables:
  83.  
  84.           aaaarrrrggggcccc           Contains  a  count  of  the  number  of   _a_r_g
  85.                          arguments  (0  if  none),  not  including the
  86.                          options described above.
  87.  
  88.           aaaarrrrggggvvvv           Contains a Tcl list whose  elements  are  the
  89.                          _a_r_g  arguments  (not  including  the  options
  90.                          described  above),  in  order,  or  an  empty
  91.                          string if there are no _a_r_g arguments.
  92.  
  93.           aaaarrrrggggvvvv0000          Contains  _f_i_l_e_N_a_m_e  if  it   was   specified.  |
  94.                          Otherwise,  contains  the  name by which wwwwiiiisssshhhh  |
  95.                          was invoked.                                   |
  96.  
  97.           ttttccccllll____iiiinnnntttteeeerrrraaaaccccttttiiiivvvveeee                                                    ||
  98.                          Contains   1  if  wwwwiiiisssshhhh  is  reading  commands  |
  99.                          interactively (no ----ffffiiiilllleeee option was  specified  |
  100.                          and   standard   input   is  a  terminal-like  |
  101.                          device), 0 otherwise.
  102.  
  103.  
  104.      SSSSCCCCRRRRIIIIPPPPTTTT FFFFIIIILLLLEEEESSSS
  105.           If you create a Tcl script in a file whose first line is
  106.  
  107.                ####!!!!////uuuussssrrrr////llllooooccccaaaallll////bbbbiiiinnnn////wwwwiiiisssshhhh ----ffff
  108.           then you can invoke the script file directly from your shell
  109.           if  you  mark  it as executable.  This assumes that wwwwiiiisssshhhh has
  110.           been installed in the default  location  in  /usr/local/bin;
  111.           if  it's installed somewhere else then you'll have to modify
  112.           the above line to match.
  113.  
  114.  
  115.      PPPPRRRROOOOMMMMPPPPTTTTSSSS
  116.           When wwwwiiiisssshhhh is invoked interactively it normally  prompts  for  |
  117.           each  command  with  ``%%%%  ''.   You can change the prompt by  |
  118.           setting  the  variables  ttttccccllll____pppprrrroooommmmpppptttt1111  and  ttttccccllll____pppprrrroooommmmpppptttt2222.   If  |
  119.           variable  ttttccccllll____pppprrrroooommmmpppptttt1111  exists  then it must consist of a Tcl  |
  120.           script to output a prompt;  instead of outputting  a  prompt  |
  121.           wwwwiiiisssshhhh  will evaluate the script in ttttccccllll____pppprrrroooommmmpppptttt1111.  The variable  |
  122.           ttttccccllll____pppprrrroooommmmpppptttt2222 is used in a similar way when a newline is typed  |
  123.           but  the  current command isn't yet complete; if ttttccccllll____pppprrrroooommmmpppptttt2222  |
  124.           isn't set then no prompt is output for incomplete commands.
  126.  
  127.  
  128.      Page 2                                          (printed 7/23/95)
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.      wwwwiiiisssshhhh((((1111))))                     TTTTkkkk ((((3333....3333))))                      wwwwiiiisssshhhh((((1111))))
  136.  
  137.  
  138.  
  139.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  140.           shell, toolkit
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.      Page 3                                          (printed 7/23/95)
  195.  
  196.  
  197.  
  198.